home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 076-100 / disk_082 / amicterm / amic.new < prev    next >
Text File  |  1992-05-06  |  45KB  |  957 lines

  1. =====================================================================
  2.               AMIC Development presents
  3.               AMIC PD Term
  4.  
  5.               By: David Salas & Albert Kirk
  6. =====================================================================
  7. Version: Release beta 50
  8. Date   : June 25, 1987
  9. Time   : 15:20:00
  10. Status : RELEASE GRANTED FOR ALL USERS, ALL BBS's
  11. =====================================================================
  12.                           *** NOTE ***
  13.  
  14. AMIC PD TERM was  originally made from Dan James (DJJ) source to COMM
  15. version 1.34, but has evolutionized im the last couple weeks into its
  16. very own environment. I was actually going to adopt the name of COMM
  17. version 2.0, but on requests of DJJ I have adopted this new name. But
  18. Dan sure deserves some credit on it, even if the program doesn't look
  19. too similar at all.  Most of the I/O  and Transfer  protocol routines
  20. are intact,  with few changes,  this will ultimately  change,  HAS to
  21. change to accomodate our MultiTalk protocol,  and it will improve I/O
  22. speed greately by using assembly made routines. Thanks and ENJOY this
  23. BETA version of AMIC PD TERM,  this BETA status implies that the pro-
  24. gram might have some bugs here and there,  and that some of the items
  25. available are  not actually implemented. Just be patient,  I DO *NOT*
  26. intent to release EVERY single update to the public domain,but perio-
  27. dically,  as I have been doing for about a month since I started with
  28. it.  There are about  40 testers of it,  so I think that is enough to
  29. get enough feedback on problems with the program.  I would appreciate
  30. your feedback,  but if I don't reply  at all is because that has been
  31. taken care already  on new releases to selected  testers (mostly from
  32. AMIC).
  33.  
  34. SYSOPS: Do *NOT* delete COMM 1.34 from your  libraries,  AMIC PD TERM
  35.         is NOT considered a newer  version of this program,  nor want
  36.         to takeover the great work that DJJ has put into the original
  37.         version of COMM.
  38. ---------------------------------------------------------------------
  39.                    ** DISTRIBUTION AND COPYRIGHT **
  40. ---------------------------------------------------------------------
  41. This program is placed in the public domain as SHAREWARE. If you find
  42. this program useful, a  $20.00 registration fee will be really appre-
  43. ciated, and will help us to keep mantaining and enhancing the program
  44. on a regular basis.  At this point of time I won't release the source
  45. code, in first place because  I don't feel confortable releasing code
  46. that is not being 100% debugged, secondly,  I would rather wait until
  47. the full implementation of the  program has been completed. By then I
  48. will make the source code available one way or another.
  49.  
  50. As registered users  you are entitle  for updates of  the program  as
  51. they become available, uinlike non-registered users that only will be
  52. able to update it  whenever I release Generally  available updates of
  53. the program. These updates have to  be obtained either  by mail or via
  54. AMIC. Via mail, the only cost for you is a SASE (Self Addressed Stam-
  55. ped Envelope). Via AMIC, just the cost of the call. Also, on AMIC you
  56. will be able to read  and participate in the AMIC Development Testers
  57. Area, with hints  and information about AMIC PD TERM,  special files,
  58. etc. And best of All,  AMIC PD TERM  registered users are entitled to
  59. a $20.00 discount on GraphTerm, our commercial terminal program.
  60.  
  61. Send your registration fee to:
  62.  
  63. David Salas or Albert Kirk
  64. AMIC Development
  65. 1002 Apple Creek Lane  (NEW ADDRESS!!)
  66. Santa Rosa, CA 95401-2731
  67. ---------------------------------------------------------------------
  68.         System Requirements, suggestions
  69. ---------------------------------------------------------------------
  70. MINIMUM Configurations: - Amiga 1000/500/2000 w/512K of memory
  71.                         - One 3.5 floppy drive
  72.                         - Amiga Monitor
  73.                         - Kickstart/Workbench 1.2 or up!
  74.                           (It does NOT work under 1.1 and we don't
  75.                            plane on doing such thing)
  76.  
  77. SUGGESTED Configuration:- Extra 512K or more of memory.
  78.             - Second Floppy Drive or Hard Disk
  79.             - Printer
  80. =====================================================================
  81.                   Features of the NEW AMIC PD Term
  82. ---------------------------------------------------------------------
  83.                        BETA RELEASE .50 NEWS
  84.  
  85.                     LAST PUBLIC RELEASE FOR NOW!
  86. ---------------------------------------------------------------------
  87. ---------------------------------------------------------------------
  88. ---------------------------------------------------------------------
  89.  
  90.                             ** NOTE **
  91.  
  92. AMIC  PD  TERM  Beta  release    .60  is almost ready to be
  93. delivered. This version won't be available to non-registered users,
  94. unless the satisfaction/registrered ratio changes to a more favorable
  95. percentage. This version includes the several additions:
  96.  
  97. SCRIPT LANGUAGE: Scripts can be assigned to each phone record, or can
  98.    be loaded on the fly (taking over any loaded script if there is
  99.    any currently in memory). The following commands are available in
  100.    such release:
  101.  
  102.  
  103. About Dialing:
  104.  
  105.    AUTO ON/OFF
  106.       Sets the autoredial flag to ON or OFF.
  107.  
  108.    DIAL number
  109.       Dials <number>. If AUTO is OFF it won't try again if no carrier
  110.       was detected, but if AUTO is ON it will redial until carrier is
  111.       detected.
  112.  
  113.    HANGUP
  114.       Couldn't be simplier! It hangs up,disconnecting the system from
  115.       the host immediatly. Be kind and use this wisely, make sure you
  116.       send a goodbye command to the host before doing this!
  117.  
  118. About Flow control:
  119.  
  120.    BREAK
  121.       Sends a break to the system.
  122.  
  123.    DELAY nn
  124.       Delays <nn> amount of seconds.
  125.  
  126.    GOTO label
  127.       Goes to <label>. See RETURN
  128.  
  129.    IF "string" THEN ... ELSE  
  130.       IF <string> matches  the received data  THEN execture whatever,
  131.       ELSE does this other thing.  This IS POWERFUL stuff if you know
  132.       how.
  133.    (NOTE: IF  recursion may or may not be available in .60, but it'll
  134.     be there for sure  on a further release. Can't promise it because
  135.     still working on it, and want to have .50 available ASAP!)
  136.  
  137.    RETURN
  138.       Returns to the routine (or main)  that called  this routine via
  139.       the GOTO commands.
  140.  
  141.    SSTRING "string"
  142.       Sends such <string> to the host.
  143.  
  144.    WSTRING "string"
  145.       It will wait until the incoming text matches the <string> before
  146.       continuing. If for some reason such string does not match within
  147.       60 seconds, the program will abort this command  and resume with
  148.       the next. File transfer time does NOT count, if you ask.
  149.  
  150.  
  151. About file transfer and file capture:
  152.  
  153.    CAPTURE "path/filename"
  154.       Will start capturing  all the  console  I/O into the <filename>.
  155.       If CAPTURE OFF is  issued,  the the capture file will be cloased
  156.       and no more is  capture until such  command  with a  filename is
  157.       reissued.
  158.  
  159.    FILEDOWN "path/filename"
  160.       Initializes a  download,  creating <filename>  in the requested
  161.       path, if no path is specified, FILEDIR is used (see under CONFIG
  162.       file for more information)
  163.  
  164.    FILEUP "path/filename"
  165.       Initializes an upload of the <filename> to the host. The path
  166.       argument is obviously optional.
  167.  
  168.    PROTOCOL nn
  169.       Sets the protocol to be used for error free file transfers.
  170.             1 = XModem
  171.             2 = XModem Text
  172.             3 = WXmodem
  173.             4 = Zmodem
  174.             Others will be available as well.
  175.  
  176.    SEND "path/filename"
  177.       This will start an ASCII Send process. Simple enough.
  178.  
  179.  
  180. About thingies:
  181.  
  182.    BEEP nn
  183.       Issues <nn> beeps.  Display  Beep or Audible Beep, depending of
  184.       your current set. There is about 1/10 of a second delay between
  185.       beeps.
  186.  
  187.    LOAD "path/script"
  188.       Allows you to load a NEW script. At this point, ANYTHING on the
  189.       calling script will be  wipped out,  in other words,  you CAN'T
  190.       return to this script at all (you can reload it fron the called
  191.       script file,  but  it won't continue  where you left  over, use
  192.       GOTO instead!
  193.       This is  useful if you need  EXTREMELY long  scripts that don't
  194.       fit on your memory!  With good planing  you can use  scripts to
  195.       control everything on a very large net. Have fun!
  196.       If NO path is given, LOOKDIR is used as the default path.
  197.  
  198.    KEYS "path/Macro-Keys-file"
  199.       Allows you to load a different macro keys file on the fly! This
  200.       gives a really  unlimited potential  to the kind  of things you
  201.       can do with scripts and macros at the same time.
  202.       if NO path is given, LOOKDIR is used as the default path.
  203.  
  204.    MACRO F-Key
  205.       Sends the string stored in the F-Key macro.  This is  very nice
  206.       to cut some time writing scripts!
  207.  
  208.    PRINT ON/OFF
  209.       Allows you  to set the printer ON or OFF  to capture everything
  210.       into a  hardcopy.  At the present  time this can  slow down the
  211.       whole process a lot since no buffers are provided to print, but
  212.       this will be implemented in a future version of AMIC PD TERM.
  213.  
  214.    EXIT
  215.       Sets the END  of script.  If this command  is found, the script
  216.       control is aborted and normal operation is resumed.
  217.  
  218. Other commands to be implemented in the future:
  219.  
  220.    ONTIME hh:mm:ss
  221.       Allows you to control the START of a script at a certain time,
  222.       very useful for unatended use of scripts!
  223.  
  224.    ------------------------------------------------------------
  225.                           MACROS ARE HOT!
  226.    ------------------------------------------------------------
  227.    Although I haven't implemented this yet, macros are gonna be
  228.    hot, this means that you STILL have control of the WHOLE en-
  229.    vironment, even if the script  is being ran. This allows you
  230.    to do stuff like sending a string yourself to the system and
  231.    things like this that are specially useful for debugging the
  232.    scripts.
  233.    ------------------------------------------------------------
  234.  
  235. So, this is more (and MUCH more to come) are the things that you are
  236. gonna miss if you don't register! Oh yes, a bettter and more compre-
  237. hesive manual will be  available as well for registered users.  Plus
  238. usable scripts for AMIC, GEnie and PLAIN BBS-PC host systems.
  239.  
  240. If you don't need all this power, register anyways!!
  241.  
  242. One last thing, all this is just around 80K of code, not like some of
  243. the commercial packages that need to look BIG w/o any aparent reason,
  244. in my opinion.
  245.  
  246.  
  247. David Salas
  248. Albert Kirk
  249. AMIC Development
  250. ---------------------------------------------------------------------
  251.  
  252. There are a couple more notes I want to add before I go into detail
  253. on the new features and enhancements of this release:
  254.  
  255. "I am getting an invisible requester, but when I hit the proportional
  256.  gadget everything shows up, why is that?"
  257.  
  258. Okay, this should be fixed now.  Strange thing though. DO NOT use the
  259. fix that was posted by  LILMAC (GEnie Member) for .42,  it won't work
  260. on .50 and it may even crash your system!!
  261.  
  262. "The file requester is adding to spaces to the filename, and it drove
  263. me nuts  until I realized  the problem  since the file  showed in the
  264. LIST, but I couldn't access it. Ideas?"
  265.  
  266. Yeah, I was passing a bad argument to the file requester, that is now
  267. fixed in .50, sorry for that one, the worst of all, in my opinion.
  268.  
  269.  
  270. "Many things don't show up when using 1 bit plane, specially on the
  271. requesters!"
  272.  
  273. That is fixed, bad use of colors on .42, thanks!
  274.  
  275.  
  276.  
  277. I guess that is it for now. Now lets get to the new features:
  278. ---------------------------------------------------------------------
  279. FILE TRANSFER: Enhancements and fixes!
  280.  
  281.  o It seems like sometimes the sytem would locked up on a file trans-
  282.    fer, after debugging the whole transfer loop, we found the problem,
  283.    and better yet, we fixed it! It should work perfect now!
  284.  
  285.  o And good news, the  speed should be improved by  at least 20%, if
  286.    not more.  I will make some tests and let ya know,  but we cut the
  287.    checksum/CRC and  character processing overhead on file transfers.
  288.    The only little problem is that if you want to abort the transfer,
  289.    you might need to press  the ESC key more than one time before the
  290.    program aknowledges it.  This is because  we are not  checking for
  291.    system events only one time per loop, instead of three times as it
  292.    was doing before (which added a tremendous amount of overhead!)
  293.  
  294.  
  295. FILE REQUESTER: Enhancements and fixes!
  296.                 Tell me if you have seen a nicer, while intuitive
  297.                 file requester!
  298.  
  299.  o Speed improvements, faster than ever! And now more optimized for
  300.    floppy drives while very fast on hard drives (and RAM Disks).
  301.  
  302.  o Now featuring Images! Disk and  Drawer Images  on the gadgets make
  303.    things  more user friendly,  nice, neat!  (I considered being even
  304.    more selective, but the heck with it, that takes MEMORY!).
  305.  
  306.  o The file requester now is smarter,  it does not duplicate drawers/
  307.    disks in the requester, so you won't see those df1: df1: df1: any-
  308.    more. The only caution is that it is case sensitive, so, make sure
  309.    to set LOOKDIR, FILEDIR & DEFDIR in UPPER CASE. See for yourself!
  310.  
  311.  o Brand new UP and DOWN Arrows, with smooth scrolling make life much
  312.    easier with this requesters! And yes, it is continuous, just leave
  313.    your  mouse pressed  over the arrow  and it will  scroll until you
  314.    release the mouse button! (LEFT).
  315.  
  316.  o Proportional gadget makes page scrolling a possibility!
  317.  
  318.  o Oh yes, no more extra spaces in the requester filename.
  319.  
  320.  o you can now pop it up while receiving text (or entering text) into
  321.    the host. It was not working this was in .42.
  322.  
  323.  
  324. PHONE REQUESTER: Enhancements and fixes!
  325.  
  326.  o Fast, yes, very fast.
  327.  
  328.  o EDIT is now working!  Select EDIT, click  on the phone  record you
  329.    want to edit, and get to work! Simple and easy. If you want to re-
  330.    edit the whole record,  just clear it with RIGHT-AMIGA-X (It is an
  331.    Intuition String Gadget).
  332.  
  333.    EDIT does allow you to ADD or  DELETE a phone entry. At the end of
  334.    the list, you will see a  BLANK line, use it to ADD  a new number,
  335.    a new line will be added once you EDIT that BLANK one.
  336.    to DELETE a record,  select the entry,  CLEAR IT,  and hit return,
  337.    and it will be taken off for ya. Piece of cake, isn't it?
  338.  
  339.    EDIT allows you to change your mind when selected, this means that
  340.    if you selected a phone  number that you  didn't want to edit, but
  341.    another is,  you can  simply go and click  over  the correct phone
  342.    record, and it will be available for editing at once.
  343.  
  344.  o SAVE must go  along with EDIT,  of course, so you can now save the
  345.    phonelib, you get a requester where you can select the filename to
  346.    save the phone library.
  347.  
  348.  o Displays the number of entries you have in the library, so you can
  349.    tell how many more you can enter.
  350.  
  351.  o Yes, propotional gadget too, so you can scroll a page at a time!
  352.  
  353.  o and UP and DOWN arrows as well, and boy,  does it scroll smoothly!
  354.    (NOTE: If you don't have  FastMEM, your requesters  will be slower
  355.    than on a system with FastMEM. Obvious, isn't it?)
  356.  
  357.  o You can enter the phone library you want to load into the PhoneLib
  358.    string gadget, and the program will  go and load if w/o popiing up
  359.    the file requester. If  such phone lib  does not exist, the system
  360.    will simply return w/o changing anything (no warning message YET).
  361.  
  362.  
  363. MACROS REQUESTER: BRAND NEW!
  364.  
  365.  o Another nice requester for AMIC PD TERM. Tired of that SHIFT HELP,
  366.    Editing string, etc? Now with this requester you can see your key
  367.    macros, EDIT, LOAD, SAVE, LIST your macros from the same place!
  368.  
  369.    The are seven gadgets that perform as follow:
  370.  
  371.    - OKAY    : When you are satisfied with it your changes, just use
  372.                this gadget to resume to the terminal program.
  373.    - LOAD    : Pops up the file requester, which list those .Keys key
  374.                file you have in the logged directory. Select it and
  375.                just watch it loading and displaying the new macros.
  376.    - EDIT    : Select the gadget, click on the macro you want to EDIT
  377.                and go to work! It allows upto 256 chars per macro.
  378.    - SAVE    : Once you have edited your macros you obviously want to
  379.                save them, nothing easier than this one!
  380.    - CANCEL  : It actually does not cancel anything but the requester
  381.                but it will  soon abort and  restablish  everything to
  382.                the way it was before selecting this requester.
  383.    - NORMAL/SHIFT: Allows you to switch between UnShifted and Shifted
  384.                functions keys. You will see, try it!
  385.  
  386.  o The other gadget  is the MacroLib  string gadget showing the macro
  387.    file being in use. Type the filename of the macro you want to load
  388.    and the system will go and load  it (if it exists, otherwise it'll
  389.    return and continue normally (no warning message YET)).
  390.  
  391.  o DO **NOT** try to pop this (or ANY for this matter) requester when
  392.    a file  transfer  is on its way,  I know I should  trap such  user
  393.    action,  but plans are that user  will be able to  do such  thing,
  394.    which will be VERY handy for macros,  since you will be able to go
  395.    and edit  a macro  with all the  stuff to download your next file,
  396.    press the F-Key and voila, no loose of time..
  397.  
  398.  
  399. COLOR REQUESTER: Fixes, enhancements!
  400.  
  401.  o It seems that  some memory  corruption was  happening when loading
  402.    color files, this should not happen any more on this release.
  403.  
  404.  o you can now pop it up while receiving text (or entering text) into
  405.    the host. It was not working this way in .42.
  406.  
  407.  
  408. CHECKSUM vs CRC: This  flag setting  was not working  at all, even if
  409.    the user selected CHECKSUM the  program would go  and do check for
  410.    CRC first, and since  VAXES Xmodem implementation is so primitive,
  411.    it would not work due to timeout  from the VAX  before the AMIC PD
  412.    TERM would go down to CHECKSUM. This should be working now.
  413.  
  414.  
  415. HELP REQUESTER: This  requester now displays  CORRECTLY  the filename
  416.    that is being used for text capture.  This also means that the de-
  417.    fault file, CAPTURE.TXT is passed onto the  file requester  as the
  418.    default one if none other has been used yet.
  419.  
  420. **
  421. NOTE: DIRECTORY NAMES ---> in the Amic.Config file can have NO MORE
  422.       than THREE  (3) letters or numbers!!!!!!
  423. **
  424. ---------------------------------------------------------------------
  425.                        BETA RELEASE .42 NEWS
  426. ---------------------------------------------------------------------
  427.  
  428. The first and most important problem seems to be with Auto-redialing,
  429. I am checking the DTR signal to know if the program got a carrier, if
  430. carrier is present,  the autoredialer will abort and  tell the user a
  431. carrier was detected, this USUALLY means that we got through the sys-
  432. tem you have been redialing to... Now, some modems have this DTR sig-
  433. nal enable to  be HOT all the time, that is enough  to "fool" AMIC PD
  434. TERM  which will "think" that "We ARE online" at  the moment  of ini-
  435. tializing  the autoredialing  loop, making the program  to abort  the
  436. operation like if it got through a system. Now, MOST of this modem do
  437. have a way  to turn such signal OFF, in fact, most modems should have
  438. this signal in  the OFF position. DTR ON is only useful for some  BBS
  439. programs that don't detect the DTR  by themselves. DTR always ON also
  440. allows an user to reboot the system without loosing the communication
  441. with the remote  system.  So, for MOST useful purposes, DTR should be
  442. in the  OFF position hardware-wise, meaning that it will be turned ON
  443. ONLY when you are INDEED communicated  with some other system,  some-
  444. thing that the terminal program will do for you, of course.  So, look
  445. in your manual, this signal is usually enabled or  disabled via a DIP
  446. SWITCH on your modem.  Once you have this OFF,  I am 99% that autore-
  447. dial will work for you just fine.
  448.  
  449. Another thing that users have been asking for is why the Amiga 1...10
  450. key sequence does not work anymore for dialing the top 10 numbers of
  451. your phone library don't work anymore. To answer this I will get into
  452. the way Comm 1.xx does it.. DJJ uses the COMMSEQ flag, which allows
  453. an Intuition menu to have an Alternate Key to call such menu item via
  454. the keyboard, so he allocated 1 through 10 as such keys.. Well, since
  455. AMIC PD TERM does NOT  use the menu to display the phone numbers any-
  456. more, I just can't do the same trick in the same easy way.  This does
  457. not mean that I couldn't do  something like  that, just that I didn't
  458. do it, and that it  was VERY VERY easy  to do using the  menu type of
  459. approach from DJJ.... In a future version of AMIC PD TERM you will be
  460. able to assign this type of things by yourself.... Meanwhile, the 200
  461. phone library worths this change.... and much more with this new ver-
  462. sion of the phone requester, which I will describe next.
  463.  
  464. THE DIAL REQUESTER: Enhancement and changes.
  465.    o About 10 times faster than the previous version of it.. Frankly,
  466.      this is about  the best speed  one can get using  Intuition text
  467.      primitives, period.
  468.    o Support of MULTIPLE selections for Auto-redial! Yes, this featu-
  469.      re is REALLY nice.  You can select as  many number to attempt to
  470.      get connected to.  All  the library if you want.  The first four
  471.      selections are displayed  separately on the phone requester, but
  472.      again,  you can  select as many as you wish.  Autoredial will go
  473.      and start from the top of the list, dialing each selected number
  474.      one at a time, repeating the loop until a connection is establi-
  475.      shed,  or until the user aborts  the operation.  Smart enough to
  476.      abort the  operation immediately if no selections were made.  If
  477.      you  don't have  the auto-redial flag on,  it will dial the LAST
  478.      number your selected.
  479.    o Highlights  the selections  you make,  and they are always high-
  480.      lighted until  the user exits  the requester,  or unselects such
  481.      number from the selected list (by clicking over it again).
  482.    o Also, it automatically selects Auto-redial mode if more than one
  483.      phone is selected for dialing.
  484.    o The SET  field is now supported.  This field allows  the user to
  485.      set some communication  parameters to each one of the records in
  486.      the phone library. This parameters are: Duplex, Data Length, Pa-
  487.      rity and Stop Bits.  To set  each one of them,  you set ONE byte
  488.      per parameter in the following order:
  489.            DUPLEX     : F for Full - H for Half
  490.            DATA LENGTH: 8 or 7
  491.            PARITY     : E for Even, O for Odd or N for NONE.
  492.            STOP BITS  : 1 or 2 stop bits
  493.      So, a formated field  will look something like  this:  F8N1, for
  494.      FULL Duplex, 8 Data Bits, No Parity, 1 Stop Bit. Please look the
  495.      Phone Library example accompaining this program for more info.
  496.    o Because this SET field, the format for the phone library changed
  497.      a bit. The new format is as follows:
  498.            SYSTEM NAME: 17 Bytes + 1 Space
  499.                 NUMBER: 17 Bytes + 1 Space
  500.                   BAUD:  5 Bytes + 1 Space
  501.                    SET:  4 Bytes + 1 Space
  502.                COMMENT: 23 Bytes
  503.      Again, best is to give a look to the example phone directory.
  504.      Also, The Final List (tm), from Chet Solace at Color America BBS
  505.      is now supporthing this new format.  His latest version, v5.6 is
  506.      now using this new format, which is NOT compatible with any pre-
  507.      vious releases  of AMIC PD TERM or  Comm, but it will be for all
  508.      future releases of the program (crossing fingers).
  509.    o The Alternate number  is now displayed at the Right of the phone
  510.      Library name. NONE will be displayed if Alternate Service wasn't
  511.      given in the Phone Library.
  512.    o The LOAD gadget  is now active and working,  which allows you to
  513.      load different .Phone files on the fly.
  514.    o KEYS files are now loaded  upon the name of  the system  you are
  515.      calling, ala Comm,  with the exception that it  does a  look for
  516.      a .Keys file,  so, if the entry you selected is called AMIC, the
  517.      system is going to load AMIC.Keys, IF available.
  518.  
  519. THE GET FILE REQUESTER: Enhancements and changes.
  520.    o No radical changes here, only code optimization and SPEED impro-
  521.      vement (about 300%).
  522.    o The problem with the  so-named "invisible files" should be gone,
  523.      please let me know about this,  since I was  unable to reproduce
  524.      this problems on my machines.
  525.    o The file requester is  now hot all the time, so that floppy dri-
  526.      ve scans are not as painful as it was with earlier versions. But
  527.      it is also optimized to make full use of the speed of Hard Disks
  528.      an RAM devices.
  529.    o There seemed to be some problems with the PARENT gadget, this is
  530.      also fixed.
  531.  
  532.  
  533. THE PALETTE REQUESTER:
  534.    o Also a little faster, plus code optimization.
  535.    o A bug with loading colors has been fixed,there shouldn't be more
  536.      bugs in this requester.
  537.  
  538. BORDERS ON and OFF: Fixes
  539.    o It was not working as advertised, only when the user was in chat
  540.      window (Split Window).  It now works  fine in both mode, without
  541.      any problems at all. Let me know.
  542.  
  543. THE SIDE BAR: Fixes and Changes.
  544.    o When selecting BUP or BDOWN,  the program was actually selecting
  545.      Xmodem Download and Upload,  instead of using  the protocols the
  546.      user  selected for binary  transfers.  This has been changed and
  547.      it is working properly now.
  548.  
  549.  
  550. This is for now,  sorry if I didn't add any of the unimplemented fea-
  551. tures in this releae,  but I was more into optimizing code and enhan-
  552. cing current feature.
  553.  
  554. ---------------------------------------------------------------------
  555.                        BETA RELEASE .41 NEWS
  556. ---------------------------------------------------------------------
  557. Only fix here was a  bug with the SideBar,  when selecting Binary Up,
  558. the program was actually processing Binary Download.
  559. This release  was in a HURRY, a  problem I found  important enough to
  560. go ahead and re-release it just about an hour after .40 was released!
  561.  
  562. ---------------------------------------------------------------------
  563.                        BETA RELEASE .40 NEWS
  564.            *** FIRST RELEASE TO THE GENERAL PUBLIC ***
  565. ---------------------------------------------------------------------
  566. DIAL REQUESTER: Speed has been improved,  making it  about 30% faster
  567.           than on version .39.. Don't worry,  it will be very fast in
  568.           future versions. But it ain't THAT slow, is it?
  569.  
  570. MENU PROJECT:
  571.    o ABOUT does now call the STATUS window, which is also callable by
  572.      pressing the HELP key.
  573.  
  574. MENU SETUP:
  575.    o AUDIBLE BEEP: Allows you to select between and AUDIBLE  beep and
  576.      a screen beep (DisplayBeep()). If AUDIBLE the MenuItem is Check-
  577.      marked. This flag is configurable from the .Config file, see be-
  578.      low.
  579.    o AUDIBLE BELL: Allows you to set for Audible or Screen beep. Read
  580.      below for more information.
  581.  
  582.    o BORDER: It now works correctly on SPLIT WINDOWS.
  583.  
  584. CONFIG FILE: Two new command additions to it:
  585.  
  586.    o BELL [ON/OFF]: Select between  Bell being Audible or not.  ON is
  587.                     Audible, OFF is DisplayBeep();
  588.  
  589.    o BORDER [ON/OFF]: Allows you to  preselect the type of Window you
  590.                     want the program to come with.  ON means the win-
  591.                     dow has borders.  OFF means the window  does come
  592.                     without  any borders. This  is true  for the  I/O
  593.                     window only,  *NOT* for any other  windows in the
  594.                     system.
  595.  
  596. Minor  requesters have  been improved in the way they look, including
  597. the STATUS requester. No big deal.
  598. ---------------------------------------------------------------------
  599.                       BETA RELEASE .39 NEWS
  600. ---------------------------------------------------------------------
  601. MENU DIAL:
  602.    o DIAL: COMPLETELY different  from the  original  Comm or previous
  603.            versions of  AMIC PD Term.  It now has a window requester,
  604.            which  has a capacity  to hold upto  200 phone  entries at
  605.            the  same time.... From there you can also flag for REDIAL
  606.            and  ALTERNATE SERVICE.  At this  point you  can't  change
  607.            phone directory from the file string gadget,  use the  GET
  608.            PHONE (Amiga G) to load a new phone directory.
  609.            Plans are to support an unlimited amount of phone entries,
  610.            but I am not really sure if I want to implement it here on
  611.            AMIC PD Term.... I feel that 200 entries is enough for 99%
  612.            of the users!
  613.  
  614. GET FILE REQUESTER: Improved  and optimized  for faster speeds, it is
  615.            about 3 times  faster than it was before scrolling data on
  616.            on it.
  617.            This  requester also  has been adopted  for LOADING/SAVING
  618.            Phone Libraries and Macro Key files.
  619.  
  620. Some bugs are  fixed now,  and the program is faster than on beta .38
  621. in I/O. Here are some of those I remember beforehand! :-)
  622.  
  623.    o The  BORDERLESS window  now does not  overwrite the CLOSE WINDOW
  624.      gadget
  625.  
  626.    o AMIGA Y does now serve as a shortcut for SEND BREAK.
  627.  
  628. ---------------------------------------------------------------------
  629.                        ORIGINAL DOCUMENTATION
  630. ---------------------------------------------------------------------
  631.                             *** USAGE ***
  632.  
  633. AMIC {[Configfile]}
  634.  
  635. Configfile is OPTIONAL, is NONE is issued, the  program will look for
  636. AMIC.Condfig in the CURRENT directory, if no luck (can't find it), it
  637. will look in the S: directory,  if still no luck,  it will use a hard
  638. coded configuration.
  639. ---------------------------------------------------------------------
  640. I will go  directly into  explaining  the features of the  program by
  641. describing  the menus on  the program,  which reach about all the pos-
  642. sibilities of the program:
  643.  
  644. PROJECT MENU:
  645.    o ABOUT: NOT implemented right now.
  646.  
  647.    o SIDEBAR: Toggles the SideBar.  It actually is  moving it  to the
  648.               background if it is in the foreground, and viceversa.
  649.               This function is called when the BACK gadget is clicked
  650.               on the SideBar window.
  651.  
  652.    o START BUFFER: NOT Implemented: This feature will allow you to
  653.               open and close the program buffer. Different to CAPTURE
  654.               indeed, it will have an user definable buffer that resi-
  655.               des in the system at all time (when toggled), which the
  656.               user can review entirely with the VIEW Buffer function,
  657.               or scrolling back using the ARROW keys.
  658.  
  659.    o VIEW BUFFER: Allows  you to review the  buffer in an editor type
  660.               of environment. NOT IMPLEMENTED.
  661.  
  662.    o PRINT BUFFER: If the PRINTER  was NOT on, and you want to have a
  663.               hardcopy of the present  information in the buffer, se-
  664.               lect this item.. NOT IMPLEMENTED.
  665.  
  666.    o PRINTER ON: Toggles and  untoggles the printer.  If it is in the
  667.               ON (Checkmarked) it  will turn the printer  off and un-
  668.               check the item.. and viceversa.
  669.               NOTE: This process is  called when the  PRINT Gadget is
  670.               selected from the SideBar.
  671.  
  672.    o LOAD CONFIG: NOT IMPLEMENTED: Allows  you to load a  Config file
  673.               and  reconfigure the  terminal program  entirely.  NOTE
  674.               that you will need to be OFF line to  execute this pro-
  675.               gram, otherwise  you will loose the carrier in the pro-
  676.               cess (NOT FATAL ERROR).
  677.  
  678.    o EXEC SCRIPT: NOT IMPLEMENTED: Allows the  user to load a  script
  679.               file and start the execution of it. The SCRIPT language
  680.               hasn't been established entirely at this time, but will
  681.               have functions  for full remote  operation of BBS's and
  682.               Network systems for downloading of files, execution can
  683.               capture of text files, message bases, etc..... Also the
  684.               ability to put the system  to sleep  until a determined
  685.               time, on which it will start to execute the script file.
  686.  
  687.    o QUIT AMIC PD: Allows  you to quite  the program,  after  closing
  688.               buffers, capture files,  and all the ports & windows of
  689.               the system. It also makes the similar of the SWEEP pro-
  690.               gram to ensure that data is not layed around. That also
  691.               forces the serial.device to be unloaded of the system.
  692.               NOTE: This process is called when the QUIT gadget is se-
  693.               lected from the SideBar.
  694.  
  695. ---------------------------------------------------------------------
  696.  
  697. SETUP MENU:
  698.    o BAUD RATE: Simple enough. Allows the user to  set the Baud Rate.
  699.               The default  Baud rate can be defined  by the user from
  700.               the Config file,  if none is defined, it  will use 1200
  701.               Baud as the default.
  702.  
  703.    o PARITY:  Allows you to set the PARITY check of the communication
  704.               session to ODD, EVEN or NONE.
  705.  
  706.    o DATA LENGTH: Allows you to set the data length to 7 or 8 bits.
  707.  
  708.    o STOP BITS: Allows you to set the stop bits to  either 1 or 2, if
  709.               possible (ie: 2 stop bits are  not possible if the data
  710.               length is set to 8 bits.
  711.  
  712.    o DUPLEX:  Allows you to set the duplex to FULL or HALF duplex.
  713.  
  714.    o CR's, LF's: Allows you to Toggle or Untoggle Linefeeds for Inco-
  715.               mig or outcoming data.
  716.  
  717.    o XON/XOFF: Toggles Handshaking to none or automatic.
  718.  
  719.    o SEND BREAK: Sends a break to the host.
  720.  
  721.    o SPLIT WINDOW: Will split windows for CHAT mode, with one to show
  722.               the receiving data,and the other to contain your input.
  723.               VERY handy for network chatting.
  724.  
  725.    o BORDERS: Allows you to set or unset borders for the Input window
  726.  
  727.    o INTERLACE: NOT IMPLEMENTED:Allows you to change to INTERLACE and
  728.               NON INTERLACE screens on the fly.
  729.  
  730.    o COLUMNS: NOT IMPLEMENTED: Allows you  to change  fonts,  from 80
  731.               columns to 128 (upto over 132 in overscan mode) cols,or
  732.               viceversa.
  733.  
  734.    o COLORS:  Brings up the  COLOR requester, on which you can CHANGE
  735.               the current colors,  LOAD an already  saved color file,
  736.               or SAVE your current palette into a file for future use
  737.               The FILE requester *IS* case sensitve, and it'll search
  738.               for files with the extension "Color".
  739.               NOTE: This  process is called  when the COLOR gadget is
  740.                     selected from the SideBar.
  741. ---------------------------------------------------------------------
  742.  
  743. TRANSFER MENU:
  744.    o START ASCII CAPTURE: Allows you  to open a file on which to cap-
  745.               ture the  I/O  from the terminal  for later  review (or
  746.               whatever). Once on capture, this item  changes to CLOSE
  747.               CAPTURE file, which closes the file when selected.
  748.               NOTE: This process is called  from the SideBar when the
  749.                     CPTURE gadget is selected.
  750.  
  751.    o START ASCII SEND: Allows you to  send an ASCII  file to the host
  752.               system. It  will add the  Linefeeds to the file if it's
  753.               toggled in CR's/LF's (See Setup).
  754.               NOTE: This process is called if the ASEND gadget is se-
  755.                     lected from the SideBar.
  756.  
  757.    o BINARY RECEIVE: Allows you to start a Binary file Receive, which
  758.               will be  requested with  the protocol selected with the
  759.               SET PROTOCOL (see below).  If such protocol is not sup-
  760.               supported by the host, the terminal will drop to Xmodem
  761.               NOTE: This  process is called  if the  BDOWN gadget is
  762.                     selected from the SideBar.
  763.  
  764.    o BINARY SEND: Allows you to start a  Binary file Send, which will
  765.               be transfered using the selected protocol on SET PROTO-
  766.               COL (see below). If the host does not support such pro-
  767.               tocol, the program will drop down to Xmodem protocol.
  768.               NOTE: This process is called if the <BUP> gadget is se-
  769.                     lected from the SideBar.
  770.  
  771.    o SET PROTOCOL: Allows you to set the protocol of your preference,
  772.               note that Xmodem, Xmodem Ascii and WXmodem are the only
  773.               ones supported  at the present time.  MultiTalk  may or
  774.               may not be supported in  the future,  it all depends on
  775.               the progress of GraphTerm.  The default protocol can be
  776.               set from the AMIC.Config file(see below for more info),
  777.               if none is set, the terminal defaults to Xmodem.
  778.  
  779.    o PROTOCOL MODE: Allows you to select between Checksum or CRC cor-
  780.               rection mode.
  781.  
  782.    o AUTOCHOP: Checkmarked if toggled, unchecked if not... Also it is
  783.               ignored if the extension  given to the file to transfer
  784.               has the .ARC or .ZOO extension.
  785.  
  786.    o VIEW TRANSFERS: Use only to view transfers that contain readable
  787.               ASCII information, otherwise you'll get  unpredicatable
  788.               information on the window.
  789.  
  790. ---------------------------------------------------------------------
  791.  
  792. PHONE MENU:
  793.  
  794.    o DIAL:    Read UPDATED information for more.
  795.               NOTE: This  process is called  when the DIAL  gadget is
  796.                     selected from the SideBar.
  797.  
  798.    o HANGUP:  Sends a HANGUP command to your modem.
  799.  
  800.    o AUTOREDIAL: Toggles/Untoggles the Autodial flag.  If checkmarked
  801.               the program will redial the  selected phone entry until
  802.               connection is made, or until the user aborts the opera-
  803.               tion.  This are  the different things  you can do while
  804.               autodialing.. At this point the only GADGET you can se-
  805.               lect and make it to respond is the SCREEN Gadget in the
  806.               sidebar, which will bring the Back screen to the front,
  807.               placing the terminal screen in the background.
  808.               The following a KEY commands:
  809.               ESC Key: ABORTS the Autoredial process.
  810.               TAB Key: SKIPS the actual loop, forcing a new dial,this
  811.                        is VERY useful if  you are around and can hear
  812.                        the BUSY beep,  so  you are  sure it won't  go
  813.                        through, thus forcing a  new redial before the
  814.                        whole time loop is done.
  815.               UP ARROW: INCREASES the amount of time for each dial.
  816.               DOWN ARROW: DECREASE the time for each dial loop.
  817.  
  818.               NOTE: If you  are working on another screen at the time
  819.                     of the connection using  Autoredial, the Terminal
  820.                     screen will pop up automatically. Many  love this
  821.                     feature (per feedback),but others may not, let me
  822.                     know!
  823.  
  824.    o ALT SERVICE: Toggles or Untoggles the ALTERNATE SERVICE flag. If
  825.               set  the system  will add the  alternate number to your
  826.               entry everytime it dials.
  827.  
  828.    o LOAD PHONE: Allows you to load a new phonedirectory.
  829.  
  830.    o MACRO KEYS: Allows you to LOAD, SAVE or EDIT a macro keys file.
  831. ---------------------------------------------------------------------
  832.  
  833. UTILITIES MENU:
  834.    o NEWCLI: Allows you to open a NewCLI process in the WB window.
  835.  
  836.    o ARC FILES: NOT IMPLEMENTED: And perhaps it won't be.
  837.  
  838.    o UNARC FILES: NOT IMPEMENTED: Allows you to UnARC files online.
  839.  
  840.    o LOAD EDITOR: Loads AmigaDOS ED, on which you can edit files.
  841.  
  842. ---------------------------------------------------------------------
  843.                              Other commands
  844. ---------------------------------------------------------------------
  845. SHIFT HELP: Displays a list of the define macros.
  846.  
  847. HELP:       Opens a small window that gives some helpful information.
  848.  
  849. RIGHT AMIGA 0 through RIGHT AMIGA 9: Attached to the first 10 phone
  850.             entries on your directory.
  851.  
  852. F1 - F10:   Attached to the user definable macro keys.
  853.  
  854. ---------------------------------------------------------------------
  855.                                SideBar
  856. ---------------------------------------------------------------------
  857. SCREEN: Sends the terminal program to the back screen,bringing the WB
  858.         (most likey) as the front screen.
  859. BACK:   Sends the SideBar to the Back of the I/O window.
  860. COLOR:  Calls the SETUP/COLOR window requester function.
  861. DIAL:   Calls the PHONE/DIAL window requester function.
  862. HANGUP: Calls the PHONE/HANGUP function.
  863. SCRIPT: Calls the PROJECT/EXEC SCRIPT function.
  864. BDOWN:  Calls the TRANSFER/BINARY RECEIVE function.
  865. BUP:    Calls the TRANSFER/BINARY SEND function.
  866. CPTURE: Calls the TRANSFER/START(STOP) CAPTURE FILE function.
  867. ASEND:  Calls the TRANSFER/START(STOP) ASCII FILE SEND function.
  868. PRINT:  Calls the PROJECT/PRINTER ON function.
  869. UNARC:  Calls the UTILITIES/UNARC function.
  870. NEWCLI: Calls the UTILITIES/NEWCLI function.
  871. QUIT:   Calls the PROJECT/QUITE PD function.
  872.  
  873. ---------------------------------------------------------------------
  874.                           Config File
  875. ---------------------------------------------------------------------
  876. The following are the different commands supported by the Initializa-
  877. tion Configuration file.. This file must either reside on the CURRENT
  878. or S: directories, otherwise a set of pre-default settings are used.
  879.  
  880. PRIORITY:  The system priority you want to set to the terminal prog.
  881.  
  882. VERSION:   The string you want on the Title bar. DON'T CLAIM the pro-
  883.            gram is your own work!! :-)
  884.  
  885. INTERLACE: Allows the user to select  between INTERLACE/NON-INTERLACE
  886.            as the work screen.. It DOES support full overscan mode.
  887.  
  888. PLANES:    Allows the user to set the  number of bitplanes to be ope-
  889.            ned when the program is invoked... I DO support upto 3 bit
  890.            planes, but the program will allow you to set 4 and even 5
  891.            bit planes, but don't tell me if it does not work.
  892.  
  893. NUMBUFFS:  Allows you to set the  number of Xmodem buffers (128 bytes
  894.            long) you want to keep in buffer for file receptions.
  895.  
  896. BAUDRATE"  Allows you to  set the Baud Rate to be used as the default
  897.            when the program is invoked.
  898. PROTOCOL   Allows you to set the protocol of use for file transfer.
  899.               0 = Xmodem
  900.               1 = Xmodem Ascii
  901.               2 = WXmodem
  902.               3 = Zmodem        (NOT YET IMPLEMENTED)
  903.               4 = Kermit        (NOT YET IMPLEMENTED)
  904.               5 = Multitalk     (NOT YET IMPLEMENTED)
  905.  
  906. DIALTIME:  Time to be set as  call to call time between call attempts.
  907.            In seconds.
  908.  
  909. GETCOLOR:  If on, the system will load the defined .Color file and set
  910.            those colors to the terminal program. If OFF, the WB colors
  911.            are used for the first 4 colors,and other predefined colors
  912.            as colors 5 through 8.
  913.  
  914. LOOKDIR:   This is the Directory Path on  which the  program will look
  915.            for the PHONE, KEYS & COLOR files.  If the file isn't found
  916.            in LOOKDIR it will go and look in DEFDIR.
  917.  
  918. PHONE:     The filename of the file containing your phone directory.
  919.  
  920. KEYS:      The filename of the file containing your default KEYS.
  921.  
  922. COLOR:     The filename of the file containing your COLOR file.
  923.  
  924. FILEDIR:   The directory path on which file transfer will reside. This
  925.            is just a default, you  can change to a different path any-
  926.            time you want.
  927.  
  928. DEFDIR:    The path on which the terminal program will look  for files
  929.            if they are not found in the LOOKDIR path.
  930.  
  931. NOTE: LOOK Update notes for new commands.
  932.  
  933. ----------------------------------------------------------------------
  934.                            A NOTE ABOUT PATHS
  935. ----------------------------------------------------------------------
  936. I *HIGHLY*  recommend  users  to set 1 to 3 letter  paths for LOOKDIR,
  937. DEFDIR and FILEDIR, since they  will be attached to the FILE REQUESTER
  938. if Disk Icons are available..
  939.  
  940. ----------------------------------------------------------------------
  941.                          The Getfile requester
  942. ----------------------------------------------------------------------
  943. This requester is probably one of the best around for this, it is very
  944. smart, looking and assigning those devices YOUR system has to the disk
  945. icons, if you have less  than 6 devices,  it will assign some  of your
  946. PATH's (LOOKDIR, FILEDIR and DEFDIR) to  those remaining disk gadgets,
  947. making life much easier. It also has a  PARENT directory gadget, which
  948. will go one level down through the path, if selected.
  949. Also the filesize of each file is displayed, and better, you only need
  950. to click on it to get the aproximate time it will take for the file to
  951. be transfered to the host.
  952. ----------------------------------------------------------------------
  953. Boy, I am tired, so, that is it for now!
  954. ======================================================================
  955.  
  956.  
  957.